---
title: "Create Dashboard"
description: "Learn how to create dashboards in OpenLIT with step-by-step instructions for adding widgets, configuring visualizations, and building effective monitoring visualizations."
---

<iframe className="w-full aspect-video" src="https://www.youtube.com/embed/Bq0d8vFvDX8?list=PLgErWFh-dyiGp9yUDnnx67wHEeNqzzMXZ" title="Creating Your First Dashboard in OpenLIT – Build Visual Insights Fast" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>

## Steps

<Steps titleSize="h4">
  <Step title="Create a new dashboard">
    <Frame>
      <img src="/images/create-dashboard-form.png" />
    </Frame>

    1. Navigate to the **Dashboards** section in the main navigation
    2. Click the **Create new dashboard** button in the top right corner
    3. A **"Create a new dashboard or folder"** popup will appear
    4. **Fill in the dashboard details**:
       - **Name**: Enter a descriptive name (e.g., "LLM Observability")
       - **Description**: Describe the dashboard's purpose (e.g., "Dashboard to view telemetry from LLM apps and AI Agents")
       - **Tags**: Add relevant tags for organization and searchability
       - **Type**: Select **Dashboard** (Dashboard with widgets)
    5. Click the **Add** button to create your dashboard
    6. You'll be taken to the empty dashboard canvas ready for widgets
  </Step>
  <Step title="Add your first widget">
    <Frame>
      <img src="/images/dashboard-empty.png" />
    </Frame>
    1. Click **Create Your First Widget** button on the empty dashboard
    2. You'll see a **"Select a Widget"** popup with two options:
      <Frame>
        <img src="/images/dashboard-select-existing-widget-popup.png" />
      </Frame>
       - **Choose from existing widgets**: Select from pre-built widgets like "Avg temperature", "Avg utilization percentage", "Requests per time", etc.
       - **Create new widget**: Click **+ Create New Widget** to build a custom widget
       <Frame>
        <img src="/images/dashboard-select-new-widget-popup.png" />
      </Frame>
  </Step>

  <Step title="Configure widget">
    When creating a new widget, you'll see a configuration panel with three tabs:
    **General Tab**
    <Frame>
        <img src="/images/dashboard-widget-configuration-general.png" />
    </Frame>
    1. **Widget Title**: Enter a descriptive name (e.g., "Total Requests")
    2. **Widget Type**: Select from **Stat Card** in this example
    3. **Description**: Add context about what the widget shows
    4. **Value Path**: Specify which field from your query to display (e.g., `0.count()` in this example)
    5. **Prefix**: Add symbols before the value (e.g., `$` for costs)
    6. **Suffix**: Add units after the value (e.g., `%` for percentages)

    **Query Tab**
    <Frame>
        <img src="/images/dashboard-widget-configuration-query.png" />
    </Frame>
    1. **Write your SQL query** against the ClickHouse database. For example:
       ```sql
       SELECT count(*) FROM otel_traces
       ```
    2. **Test your query** by clicking **Run Query**
    3. **Verify the results** - you'll see output like: `{"count()": 622}`
  </Step>

  <Step title="Save your widget">
    1. Click **Save Changes** to add the widget to your dashboard
    2. The widget will appear on your dashboard canvas
    3. You can immediately see your data visualization
    <Frame>
        <img src="/images/dashboard-widget-created.png" />
    </Frame>
  </Step>
  <Step title="Your dashboard is ready!">
  - **Add more widgets**: Click **Create Widget** to add additional visualizations
  - **Resize widgets**: Drag the corners of any widget to adjust its size
  - **Move widgets**: Drag widgets to rearrange their positions on the dashboard
  </Step>
</Steps>
